gtk: port missing array annotations from Vala bindings

https://bugzilla.gnome.org/show_bug.cgi?id=730745

diff --git a/gtk/deprecated/gtkcolorsel.h b/gtk/deprecated/gtkcolorsel.h
index 681fe06ad0d2d28833c81c0b44ee477b94ecb3bb..21f86b6b1ffafbeeb7bb4b0d441faa39d489365e 100644 (file)
--- a/gtk/deprecated/gtkcolorsel.h
+++ b/gtk/deprecated/gtkcolorsel.h
@@ -47,16 +47,24 @@ typedef struct _GtkColorSelection       GtkColorSelection;
 typedef struct _GtkColorSelectionPrivate  GtkColorSelectionPrivate;
 typedef struct _GtkColorSelectionClass  GtkColorSelectionClass;
 
+/**
+ * GtkColorSelectionChangePaletteFunc:
+ * @colors: (array length=n_colors): Array of colors
+ * @n_colors: Number of colors in the array
+ *
+ * Deprecated: 3.4
+ */
 typedef void (* GtkColorSelectionChangePaletteFunc) (const GdkColor    *colors,
                                                      gint               n_colors);
 
 /**
  * GtkColorSelectionChangePaletteWithScreenFunc:
  * @screen:
- * @colors:
- * @n_colors:
+ * @colors: (array length=n_colors): Array of colors
+ * @n_colors: Number of colors in the array
  *
  * Since: 2.2
+ * Deprecated: 3.4
  */
 typedef void (* GtkColorSelectionChangePaletteWithScreenFunc) (GdkScreen         *screen,
                                                               const GdkColor    *colors,

diff --git a/gtk/gtkbindings.h b/gtk/gtkbindings.h
index d0c6030ec72531793d9b1b08874a3daa54ea379a..67c897acc9e6023d9a97614db59dc386cfebb8be 100644 (file)
--- a/gtk/gtkbindings.h
+++ b/gtk/gtkbindings.h
@@ -126,7 +126,7 @@ struct _GtkBindingArg
  * @next: implementation detail
  * @signal_name: the action signal to be emitted
  * @n_args: number of arguments specified for the signal
- * @args: the arguments specified for the signal
+ * @args: (array length=n_args): the arguments specified for the signal
  *
  * A GtkBindingSignal stores the necessary information to
  * activate a widget in response to a key press via a signal

diff --git a/gtk/gtkimcontextsimple.c b/gtk/gtkimcontextsimple.c
index ae9ec487018ecf09d7b354252f2ed0a0aebd1d3c..41ab8c29a9b03c100d2ead1548db88109fe8c4d3 100644 (file)
--- a/gtk/gtkimcontextsimple.c
+++ b/gtk/gtkimcontextsimple.c
@@ -1213,7 +1213,7 @@ gtk_im_context_simple_get_preedit_string (GtkIMContext   *context,
 /**
  * gtk_im_context_simple_add_table: (skip)
  * @context_simple: A #GtkIMContextSimple
- * @data: the table 
+ * @data: (array): the table
  * @max_seq_len: Maximum length of a sequence in the table
  *               (cannot be greater than #GTK_MAX_COMPOSE_LEN)
  * @n_seqs: number of sequences in the table

diff --git a/gtk/gtkrecentmanager.h b/gtk/gtkrecentmanager.h
index 94042ca894e1fd54a31924326f16da3ca58dbda5..b0a26ee0ac46f6576638b62f44d5c8235b33c24d 100644 (file)
--- a/gtk/gtkrecentmanager.h
+++ b/gtk/gtkrecentmanager.h
@@ -58,7 +58,8 @@ typedef struct _GtkRecentManagerPrivate GtkRecentManagerPrivate;
  *   “%f” and “%u” escape characters which will be expanded
  *   to the resource file path and URI respectively when the command line
  *   is retrieved;
- * @groups: a vector of strings containing groups names;
+ * @groups: (array zero-terminated=1): a vector of strings containing
+ *   groups names;
  * @is_private: whether this resource should be displayed only by the
  *   applications that have registered it or not.
  *

diff --git a/gtk/gtkselection.c b/gtk/gtkselection.c
index cbe3e48522c7e97c83e0f5eeb3321b33ec8b1765..e06652111ca70cb9d62b9273ef4200c43743bcce 100644 (file)
--- a/gtk/gtkselection.c
+++ b/gtk/gtkselection.c
@@ -1214,7 +1214,8 @@ gtk_selection_data_get_format (const GtkSelectionData *selection_data)
 
 /**
  * gtk_selection_data_get_data: (skip)
- * @selection_data: a pointer to a #GtkSelectionData-struct.
+ * @selection_data: (array) (element-type guint8): a pointer to a
+ *   #GtkSelectionData-struct.
  *
  * Retrieves the raw data of the selection.
  *

diff --git a/gtk/gtktextbufferrichtext.h b/gtk/gtktextbufferrichtext.h
index 6bd66ccc8c7f630f88013658452009e5e337c96a..75cf2d61ca6466c1e0b22d9e346493ed47908ca0 100644 (file)
--- a/gtk/gtktextbufferrichtext.h
+++ b/gtk/gtktextbufferrichtext.h
@@ -55,7 +55,7 @@ typedef guint8 * (* GtkTextBufferSerializeFunc)   (GtkTextBuffer     *register_b
  * @register_buffer: the #GtkTextBuffer the format is registered with
  * @content_buffer: the #GtkTextBuffer to deserialize into
  * @iter: insertion point for the deserialized text
- * @data: data to deserialize
+ * @data: (array length=length): data to deserialize
  * @length: length of @data
  * @create_tags: %TRUE if deserializing may create tags
  * @user_data: user data that was specified when registering the format

diff --git a/gtk/gtktreemodel.c b/gtk/gtktreemodel.c
index 6d159ef1e13508e4a876fb21ea8717d9cb7b3534..3be83088b4fe7df77ed910523676f78211adeaf0 100644 (file)
--- a/gtk/gtktreemodel.c
+++ b/gtk/gtktreemodel.c
@@ -2544,7 +2544,7 @@ gtk_tree_row_reference_deleted (GObject     *proxy,
  * @proxy: a #GObject
  * @path: the parent path of the reordered signal
  * @iter: the iter pointing to the parent of the reordered
- * @new_order: the new order of rows
+ * @new_order: (array): the new order of rows
  *
  * Lets a set of row reference created by
  * gtk_tree_row_reference_new_proxy() know that the